BlazeandCave's Advancements Pack
Version 1.11.1

By Cavinator1

Thank you for downloading this datapack by BlazeandCave.
If you liked or have any ideas for other advancements that could be added to this datapack (or found any issues) feel free to comment.

Please use Minecraft 1.16.2, 1.16.3, 1.16.4, or later for this version. The pack may or may not continue to work properly in future versions.

--- Installing: ---
1) Unzip the compressed folder that you downloaded. Inside should be this read me document and a folder labeled "bac_advancements"

2) 
For a new world: You can click the "Data Packs" option when creating a new world. Upon doing this, either open the world folder and copy in the "bac_advancements" folder, or click and drag the "bac_advancements" folder directly into the menu. Once it is imported, mouse over the icon for BlazeandCave's advancements pack so an arrow appears, then click the arrow to load the datapack.
For an existing world: Copy the folder labeled "bac_advancements". Paste it into the following folder directory in the world you want to install them in: <World name>/datapacks. 

3) Go into the world. A message should pop up saying you are using BlazeandCave's advancements pack. If not, check your advancements menu. You should see the custom tab named "BlazeandCave's Advancements"
If you forgot to load the datapack when creating from a new world, type the command: /datapack enable "file/bac_advancements"


--- Configuration: ---
The advancements pack can be easily configured using the config menu, which can be displayed by running the following command:
/function blazeandcave:config

Using the config menu you can:
- Disable and enable item rewards, trophies, and the welcome message by simply clicking their checkboxes.
- Display the advancements scoreboard on the tab list and/or sidebar. You can also clear it from there.
- Update the advancements scoreboard for all players online.
- Grant trophies for all players based on what advancements they have achieved so far.


--- The advancement scoreboard: ---
Completing each advancement triggers a function that adds one to a scoreboard, so it counts how many advancements each player on a world has obtained.

You can get the scoreboard to show up on the sidebar or the tab list using the config menu.

A number of things may cause the scoreboard to display an inaccurate score for some players, such as updating to newer datapack versions. Additionally, due to the way advancements and functions work, if a non-opped player gets an advancement they may not actually trigger any function rewards, so the scoreboard may not count for non-opped players on a server. 
Again, you can use the config menu to update the advancements scoreboard for all players online.

You can also set the advancements scoreboard to automatically update using this command:
/scoreboard players set adv_score bac_settings X
Where X is how often in seconds you want it to be updated. This setting is recommended for servers where the scoreboard won't update for non-opped players, and it is recommended that X is set to a high number for servers that are laggy or have a lot of people (e.g. 300 for 5 minutes).
X is set to 0 by default, which will cause the scoreboard to only update when someone manually updates it through the config screen (recommended for singleplayer or servers where everyone is opped)


--- Item rewards: ---
These are item and experience rewards which you are granted upon completing many advancements. By default they are turned on. They can be toggled on and off using the config menu.


--- Trophies: ---
Trophies are decorative items that you can receive upon completing some challenge advancements. Similar to item rewards they are turned on by default, and can also be toggled on and off using the config menu.

A function in the config menu will grant players every trophy they should have obtained based on which advancements they have achieved so far. This function should only be run in worlds that used the advancements pack before updating to the Trophy Update (version 1.11) so that players can obtain the trophies they missed, OR if you had trophies disabled for some time and wish to enable them but also want to gain all the trophies you would have obtained so far.

When this function is run, players that were granted trophies by this function in the past won't receive any again from the function (to prevent them from receiving duplicates if the function is run multiple times on a server). To manually re-enable trophy granting for them use the command:
/scoreboard players set <Player's Name> bac_trophy_given 0


--- Welcome message: ---
The config menu can also toggle on and off the welcome message that appears when a player first enters a world with the advancements pack installed.
This should be turned off on servers if you already have a custom welcome message of your own on that server and don't want it to be obscured by this datapack's welcome message.




--- Hardcore-Friendly Version: ---
If you intend to play on Hardcore mode, some advancements become impossible because they require you to die. The Hardcore-Friendly Version is a separate datapack that changes advancements that require you to die so that you only need to take damage from their respective sources instead.

It needs to be installed ALONG WITH the original datapack. It can be downloaded from the description on the BlazeandCave's Advancements Pack page.

Upon installing, make sure to run this command to ensure the hardcore-modified advancements are properly there
/function blazeandcave:hardcore_install


--- Updating to newer versions: ---
The Advancements Pack will undoubtedly be updated to be fixed for later versions or to add more advancements or fix bugs. In order to update, simply delete the datapack from your world, then copy and paste the new datapack folder in. Please note that when you re-enter your world some or all of the advancements you have already obtained you may need to obtain again due to changes in advancement structure.


--- Using the Language Resource Pack: ---
BlazeandCave's Advancements Pack has support for translation into other languages through use of the BACAP Language Resource Pack, which can be downloaded from the link on the Planet Minecraft page. 
- The Language Pack is a resource pack that, instead of changing textures, adds more to language files to be used by the advancements pack.
- It is installed just like any other resource pack.
- When using it, you may choose any language that the Advancement Pack supports and it will change the names and descriptions of all of the advancements into that language.

The following languages are supported, and I hope to add more in the future:
- Pirate Speak (PIRATE)
- LOLCAT (Kingdom of Cats)
- Spanish
- French
- Russian
- Portuguese
- Ukrainian
- Chinese (Simplified)
- Japanese
- Korean
If you want to help translate, you can get the base language file that comes with the language resource pack, translate it, then send it back to me. More details on how to do that are on the Planet Minecaft page.
If you are running a server, please note in the description that it supports translation using the BACAP Language Pack, and provide a link to the Planet Minecraft page.



--- What you may do with these advancements: ---
You may freely use them to play your worlds. This includes singleplayer worlds, LAN worlds with friends, or even public multiplayer servers. If you use our advancements on a public server please credit us in the server's description and leave a link to the Planet Minecraft page.

Do not re-upload my advancements and claim them as your own.

You may record a Youtube series where you use these advancements in your survival world. If you do, please credit me in the video or in the description, and leave a link to the Planet Minecraft page. And message me, too. I'd love to see you play with them.

And remember to pronounce my name right! Cavinator1 is cave-in-eight-or.


--- Troubleshooting: ---
I am aware of a number of issues involving installing advancements, particularly if you try to install them on servers. I am not an expert on servers, but here are a few questions I've been asked and how they were solved:

- The scoreboard is not working:
Type in these commands in order:
/scoreboard players objectives add bac_advancements dummy
/function bc_rewards:update_score
/scoreboard objectives setdisplay sidebar bac_advancements

- Rewards or Trophies are not given:
Make sure to check they are enabled on the config screen. By default they are turned on.

If you are on a server and are positive they are turned on, this would likely be occurring due to permissions or due to server plugins (e.g. Spigot will almost always screw with this datapack) because, sadly due to the way advancements and functions work, if a non-opped player gets an advancement they may not actually trigger any function rewards.

- The custom advancements are plain not showing up:
If the above didn't work, any number of things could be happening to cause this to happen. Try restarting the server or using the /reload command.
If you're using a spigot server, the vanilla command /reload won't work, instead type in the server's console minecraft:reload (without the backslash).
Remember when placing the advancements into your world's folder, you have to paste the "bac_advancements" folder into the following folder directory: <World name>/datapacks.
Do NOT copy them into plain <world name>/advancements - that's the folder that contains player files (i.e. a list of each player and what advancements they have gotten), not the advancements themselves.


If your question is not answered here or my advice doesn't work for you, you could try messaging me your problem, and I may be able to help you. Or try searching on Google for advice on how to fix these problems.


--- How you may contribute to our pack: ---
Have any ideas for advancements you'd like to see in the pack? I'm open to suggestions, so if you have any ideas, be sure to comment or send us a private message and we'll see if we can add it. Do note that not all suggestions may be possible to add due to limitations in advancement coding.

If you want to help me translate, you can use the base language file that comes with the BACAP Language Pack, translate it, then send it back to me. More details on how to do that are on the Planet Minecaft page.



--- List of advancements: ---
I challenge you to get all 878 advancements. :) Or at least as many as you can.

View the list of advancements here:
https://docs.google.com/spreadsheets/d/1T-5sLRZHed6uMsMl-vtz29PCVz5iMUyshB4EEtH_8ak/edit?usp=sharing



